home *** CD-ROM | disk | FTP | other *** search
/ Developer CD Series 1996 October: Mac OS SDK / Dev.CD Oct 96 SDK / Dev.CD Oct 96 SDK2.toast / Development Kits (Disc 2) / OpenDoc Development Framework / PartMaker / PartMaker Read Me < prev    next >
Encoding:
Text File  |  1996-08-16  |  4.5 KB  |  82 lines  |  [ttro/ttxt]
  1. OpenDoc
  2. Development
  3. Framework
  4.                                                                                                                                                                                      
  5. PartMaker Read Me
  6. ODF Release 1                                                                                                                                                             
  7.  
  8. Table of Contents
  9. -------------------------
  10. • What is PartMaker
  11. • Updating Your 'nmap' Resources and Signature
  12. • Building your part
  13.  
  14.  
  15. ATTENTION: you must use the PartMaker 4.4.1 provided in this folder. Earlier versions of PartMaker will not work correctly with the ODF Release 1 templates.
  16.  
  17. What is PartMaker
  18.  
  19. The PartMaker application along with the templates located in this folder allows you to quickly start a new part editor based on ODF.
  20.  
  21. We currently have six templates: three for creating a non-embedding part based on the ODFHello, ODFForm, and ODFNothing examples, and three for creating  embedding parts based on ODFContainer, ODFEmbed, and ODFTable.
  22.  
  23. The PartMaker templates for ODF can be used with all the supported development environments: CodeWarrior for PPC and 68K, Symantec C++ for MPW (68K), Symantec C++ for Power Macintosh (Rainbow), and MrC. After choosing your development environment you can throw away unused development folders. The following table indicates which folders are necessary for each supported compiler:
  24.  
  25. Folder                        CW/PPC           CW/68K            Symantec68K            MrC             Rainbow
  26.  
  27. CWPPCDebug         Y              N                 N               N             N        
  28. CWPPCRelease       Y              N                 N               N             N
  29. MCPPCDebug            N              N                 N               Y             N
  30. MCPPCRelease          N              N                 N               Y             N    
  31. RBPPCDebug            N              N                 N               N             Y    
  32. RBPPCRelease       N              N                 N               N             Y    
  33.  
  34. CW68KDebug            N              Y                 N               N             N    
  35. CW68KRelease          N              Y                 N               N             N    
  36. SC68KDebug            N              N                 Y               N             N    
  37. SC68KRelease       N              N                 Y               N             N    
  38.  
  39. We suggest that you create your new part folder in the ODFDev folder, since the project access paths are set up for that location.
  40.  
  41. Updating Your 'nmap' Resources and Signature
  42.  
  43. Whenever you create a new part, PartMaker creates a set of 'nmap' resources for your part. However, because the content of your part is likely to be different than the default content of the PartMaker part, you must change these resources to reflect your part's content. See the 'nmap', Icon, & Part Signature  document in the "Documentation:Development Notes:" folder for more information on how to do this.
  44.  
  45. The following table summarizes the creator, type, stationery type and part kind automatically generated by PartMaker for each template. 
  46.  
  47. Template                                                Creator                                Type                                                Stationery                            Part Kind                                               
  48. Container•                    ODFJ                            DFPJ                            sFPJ                             <YourCompany>:Kind:<YourPartName>
  49. Embedder•                        ODFR                            DFPR                            sFPR                             <YourCompany>:Kind:<YourPartName>
  50. Form•                                        ODFF                            DFPF                            sFPF                             <YourCompany>:Kind:<YourPartName>
  51. Hello•                                    ODFH                            DFPH                            sFPH                                <YourCompany>:Kind:<YourPartName>
  52. Nothing•                            ODFN                            DFPN                            sFPN                                <YourCompany>:Kind:<YourPartName>
  53. Table•                                    ODFT                            DFPT                            sFPT                                <YourCompany>:Kind:<YourPartName>
  54.  
  55. You need to replace the creator, file type and stationery type in three files. 
  56.  
  57. 1) In the file Binding.k, change this line:
  58. #define MyContainerOSType 'DFPJ'    ==> 'WXYZ'  (Your File Type)
  59.  
  60. 2) In the file MacMake.bmk, change this line:
  61. __ComponentSignature = 'ODFJ' ==> 'ABCD'  (Your Creator)
  62.  
  63. 3) In the file "Part.r", change four resources:
  64. resource 'FREF' (129) {
  65.     'DFPJ',  ==> 'WXYZ'    (Your File Type)
  66. …
  67. resource 'FREF' (130) {
  68.     'sFPJ',  ==> 'sXYZ'    (Your Stationery File Type (File Type with 's' as first letter))
  69. …
  70. resource 'BNDL' (128) {
  71.     'ODFJ',  ==> 'ABCD'  (Your Creator)
  72. …
  73. data 'ODFJ' (0, "Owner resource")  ==> 'ABCD'  (Your Creator)
  74.  
  75. We encourage you to change these identifiers before building your part for the first time. 
  76.  
  77. Building Your Part
  78.  
  79. Please refer to the 'Getting Started' folder which contains documentation on how to build your part for each development environment.
  80.  
  81. © 1993 - 1996 Apple Computer, Inc. All rights reserved.
  82. Apple, the Apple Logo, Macintosh, and OpenDoc are trademarks of Apple Computer, Inc., registered in the United States and other countries.